본문으로 건너뛰기

7.3.1 제한된 금액의 디지털 통화로 스캔 코드 지불 주문 생성

#간단한 설명: 디지털 통화 충전 비즈니스 인터페이스, 사용자는 QR 코드를 스캔하여 USDT(테더)를 디지털 지갑 계정(시장 환율)에 충전할 수 있습니다.

요청 매개변수​
매개변수 이름유형필수매개변수 의미매개변수 설명
keystring예판매자 키API키
localOrderIdstring예판매자 플랫폼 현지 주문 번호판매자 플랫폼은 로컬에서 고유한 주문 번호를 생성합니다
localUserIdstring아니요판매자 플랫폼 로컬 사용자 ID판매자 플랫폼 로컬 사용자 ID
notifyUrlstring아니요콜백 주소주문이 성공적으로 완료되면 API 콜백을 통해 가맹점 주소가 통보됩니다. (콜백 내용은 문서 3 참조)
successRedirectUrlstring아니요점프 주소성공 후 자동으로 해당 주소로 점프
currencystring예통화가격 책정 통화(지갑 통화)
userCurrencystring예통화사용자가 지불해야 하는 통화(지갑은 디지털 통화를 지원함)
amountnumber예금액주문가격
isBlockchainboolean아니요블록체인 정보 반환 여부(기본값 false)true인 경우 콜백 요청은 주문 체인에 거래 정보를 전달합니다
networkLimitsarray아니요메인넷TRON, BSC, POLYGON, ETHEREUM 등 지정 결제 메인넷
expireSecondLong아니요만료 타임스탬프(초)
signstring예서명자세한 내용은 서명 알고리즘을 참조하세요.
json 샘플 요청​
{
  "key": "dNNTJZpgFVWlYrVv",
  "localOrderId": "CONAN-TES1225662",
  "userCurrency": "USDT",
  "currency": "CNY",
  "amount": 10,
  "networkLimits": ["TRON", "BSC"],
  "sign": "8b949190830deb3acf5fd356f2424c72"
}

응답 JSON 예시

{
  "code": 0,
  "success": true,
  "message": null,
  "data": {
    "orderId": 474103463461061,
    "localUserId": null,
    "localOrderId": "CONAN-TES1225662",
    "orderType": "PAYMENT",
    "orderBizType": "PAYMENT_FIXED_DIGITAL_SCAN",
    "paymentUrl": "https://dxpay.dxstudio.org/fixed-amount-pay/S8hQJJWtWW2GZqLXZc9Nm8Xf32tVDoL44jYqJ59mcrMLy1Zr3RKAu4NVmLzg",
    "publicKey": "S8hQJJWtWW2GZqLXZc9Nm8Xf32tVDoL44jYqJ59mcrMLy1Zr3RKAu4NVmLzg",
    "currency": "CNY",
    "userCurrency": "USDT",
    "amount": "10",
    "userReceivableAmount": "1.49",
    "rate": "6.69220484",
    "rateExpression": "1USDT≈6.6922CNY"
  }
}

반환된 PaymentUrl은 아래와 같이 결제 페이지를 팝업으로 표시합니다.

![img](/dx-docs/7- 7、数字币代收（充值）/7.3 数字币限定金额扫码支付/usdt.jpg)

응답 데이터 매개변수 설명​
매개변수 이름유형매개변수 의미매개변수 설명
orderIdstring주문번호
localUserIdstring판매자 로컬 사용자 ID
localOrderIdstring판매자 지역 주문 번호
orderTypeenum주문 유형PAYMENT:支付订单 | WITHDRAW:提款订单
orderBizTypeenum주문업종orderBizType 유형 설명은 다음과 같습니다.
paymentUrlstring지불 주소
publicKeystring열쇠공개 액세스 키
currencystring통화 주문
userCurrencystring사용자 결제 통화
amountstring주문금액
userReceivableAmountstring이용자가 지불할 금액
ratestring환율
rateExpressionstring주문 환율 표현

orderBizType 유형 설명:​

  1. PAYMENT_WALLET_SCAN MINPAY 지갑 스캔코드 결제
  2. PAYMENT_TRANSFER 디지털 화폐 바인딩 주소 직접 입금
  3. PAYMENT_ANY_DIGITAL_SCAN QR 코드를 스캔하여 원하는 금액의 디지털 화폐를 결제하세요.
  4. WITHDRAW_WALLET MINPAY 지갑으로 돈을 인출하세요.
  5. WITHDRAW_ANY_DIGITAL_WALLET 디지털 통화를 지갑으로 인출하세요.
  6. PAYMENT_FIXED_DIGITAL_SCAN 디지털화폐 한도금액 스캔코드 결제
  7. BATCH_PAY 일괄결제

콜백은 json 데이터를 반환합니다​

기본적으로 모든 콜백 매개변수는 서명 확인에 참여합니다. 콜백 매개변수에 대한 자세한 내용은 콜백 ]를 참조하세요.

콜백 데이터​
{
  "amount": 11,
  "bizType": "PAYMENT_FIXED_DIGITAL_SCAN",
  "blockchain": {
    "network": "TRON",
    "receiverAddress": "TA1jptT16DssYWVGdVyFWxonku6hWK7En3",
    "senderAddress": "TPutFhYUQnrRxHSmKVwjp55vgk9QY6r5nS",
    "txId": "24d0d0e5d417bd2195c45d64724760ae47fc3b359ee31c5fedf25b40f3584b36"
  },
  "currency": "CNY",
  "key": "h3cS7dBltRU4W1wD",
  "localOrderId": "2820",
  "merchantActualAmount": 8.86,
  "merchantCurrency": "CNY",
  "merchantId": 303122065665,
  "merchantPaidAmount": 10.98,
  "merchantUserId": "97",
  "notifyTime": 1731572168370,
  "orderCreateTime": 1731572133082,
  "orderId": "273124814912907",
  "sign": "699806308a9e055114c378671b0d2a15",
  "status": "SUCCESS",
  "type": "PAYMENT",
  "userAmount": 1.55,
  "userCurrency": "USDT",
  "userReceivableAmount": 1.55
}

콜백 알림을 받으면 처리가 완료된 후 메시지가 성공적으로 수신 및 처리되었음을 나타내는 성공 문자열을 직접 반환해 주세요. 시스템이 성공 응답을 받은 후에는 더 이상 콜백을 반복적으로 보내지 않습니다. 예상된 응답을 받지 못한 경우(성공이 반환되지 않거나 예외가 반환됨) 시스템은 단계적 재시도 메커니즘에 따라 최대 14회 재시도하여 콜백 알림을 다시 보냅니다. 현재 재시도 간격은 다음과 같습니다. 15대, 15대, 30대, 180년대, 600년대, 1200년대, 1800년대, 1800년대, 1800년대, 3600년대, 10800년대, 10800년대, 21600년대, 21600년대